home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / faxdor13.zip / SENDFAX.DOC < prev    next >
Text File  |  1991-04-10  |  9KB  |  182 lines
  1. ==============================================================================
  2.  
  3.                          SendFax Event Utility
  4.  
  5.                FAX Service for PCBoard 14.x Message Bases
  6.  
  7.                        $20.00 to purchase SendFax
  8.                       $10.00 to Register Fax-Door
  9.  
  10.                                    or
  11.  
  12.                     $25.00 to purchase both Products
  13.  
  14.               Written by: Gerry Freymann
  15.                           R.R.#1
  16.                           Baltimore, Ontario Canada
  17.                           K0K 1C0
  18.  
  19.           The Phantom BBS (416) 342-3734 USR HST Dual Standard
  20.                           (416) 342-3766 19200 USR HST
  21.                           (416) 342-5573 19200 Hayes Ultra
  22. ==============================================================================
  23.  
  24.  
  25. Overview of SendFax
  26. ---------------------------------------------------------------------------
  27. SendFax was written to provide a simple method of scanning a PCBoard
  28. 14.x message base for outgoing Fax messages.  All you require is a
  29. Fax card and BitFax software.  How often you decide to scan for outgoing
  30. fax messages is up to you.
  31.  
  32. SendFax operates in the following manner.
  33.  
  34. Any message with a subject of FAX will be exported for faxing.  The To and
  35. From fields will be used in the covering letter.  The destination phone
  36. number should be placed on the first line of the message.  At present
  37. SendFax supports 7 digit local numbers only.  To aid in determining what
  38. your local dialing prefixes are, you can create a file called SENDFAX.PRE
  39. containing all local prefixes, one per line, but this is totally optional.
  40.  
  41. If a message is faxed out successfully, it will be (K)illed.  If there was
  42. a problem with the phone number, the original message will be flagged as
  43. Read.  If the line was busy, nothing will appear to be done to the message.
  44.  
  45. A batch file is provided, outlining how the SendFax program should be
  46. executed.  You need a version of DOS that supports the CALL feature within
  47. batch files.
  48.  
  49. We are in our initial Beta Testing, and are open to suggestions on our
  50. program.  Future plans include adding Long Distance accounts for users,
  51. and placing messages to users advising them of any problems encountered
  52. with their phone number, etc.
  53.  
  54. All in all, I think you'll be quite pleased.
  55.  
  56.  
  57. How to Purchase SendFax
  58. --------------------------------------------------------------------------
  59. SendFax is available at a cost of $20.00.  If you would like to register
  60. the door and use both programs, the total cost will be $25.00.  Print out
  61. the REGISTER.FRM in this archive and indicate you wish to purchase
  62. SENDFAX.  I'll mail out your package in the mail for an additional $5.00
  63. to cover shipping, or you may call my BBS and download the complete
  64. package.
  65.  
  66.  
  67. SendFax Requirements
  68. --------------------------------------------------------------------------
  69. First of all, SendFax may not be for everybody.  There are a few
  70. requirements you should be aware of, that may make this utility unsuitable
  71. for some Bulletin Board Systems:
  72.  
  73. - You'll need room in your computer for an internal Fax-Card.  That not only
  74.   means phsyical space, but also free interupts and com ports.
  75.  
  76. - You need an extra phone line that can be dedicated or a phone line that
  77.   can be properly time shared with the fax card.
  78.  
  79. - You need a Fax board that uses the BitFax software (C) 1989 BIT Software,
  80.   Inc.  All Rights Reserved.  I have used BitFax v.2.061 and 2.062
  81.   successfully.  BitFax 3.0 has been reported as functional as well.
  82.  
  83. - SendFax assumes a local call is 7 digits in length (minus brackets and
  84.   dashes).  If you are in a location where a local call is more, than you'll
  85.   need a customized version.  Please contact me and provide details and we
  86.   can get you set up.  Example local call:  3425544
  87.  
  88. - SendFax will ignore any phone number 8 digits or more and report these
  89.   as invalid numbers.  If this is a problem for you please contact me.
  90.  
  91. - Since this program is written in Turbo Basic file sharing is not
  92.   supported.  This will create problems if somebody else is accessing
  93.   the message base at the same time SendFax wishes to scan for outgoing
  94.   fax messages.  SendFax will retry, once per second, for up to 30
  95.   consecutive seconds, but I cannot guarantee success if your system is
  96.   up and running.
  97.  
  98.  
  99. Files used for SendFax Operation
  100. ---------------------------------------------------------------------------
  101.  
  102. SENDFAX.EXE --> The heart of our system.  This program and supporting data
  103.                 files should be placed in your \BITFAX subdirectory.
  104.  
  105.   DOFAX.BAT --> Calls up and executes SendFax and BitFax as needed.  This
  106.                 should be placed in your \BITFAX subdirectory.  If you want
  107.                 to run SendFax from your EVENT.SYS file, you should change to
  108.                 your \BITFAX subdirectory and CALL this batch file, passing
  109.                 on the full drive, path and filename of the message base you
  110.                 need scanned.  If you are going to scan more than one message
  111.                 base, just add another line to your EVENT.SYS.  The contents
  112.                 of DOFAX.BAT are as follows:
  113.  
  114.                 ECHO OFF
  115.                 :START
  116.                 SENDFAX %1
  117.                 IF EXIST DOFAXE.YES CALL FAXE
  118.                 IF EXIST FAX.END GOTO END
  119.                 GOTO START
  120.                 :END
  121.  
  122.                 DOFAXE.YES and FAXE.BAT are created by SendFax, and are used
  123.                 as key files to cycle into BitFax and eventually end.  Be
  124.                 sure to pass on the full drive, path and name of the message
  125.                 base in your batch file.  A typical example would be:
  126.  
  127.                 CALL DOFAX L:\MSGS\FAX
  128.  
  129. SENDFAX.PRE --> OPTIONAL ASCII Text file, containing a list of all valid
  130.                 dialing prefixes in your area, one prefix per line.  If
  131.                 SendFax finds this file, it will compare the prefix from
  132.                 the number in the fax message against all entries in the
  133.                 PRE file and look for match.  If there is no match, the
  134.                 message will NOT be faxed out and the message will be
  135.                 toggled as read.
  136.  
  137.     FAX.END --> Created by SendFax when the program has completed its work.
  138.                 This is the key file that signals the end.  SendFax will
  139.                 delete FAX.END when it first loads so you don't have to
  140.                 worry about it.  FAX.END will contain the date and time
  141.                 of when SendFax completed its work.
  142.  
  143. SENDFAX.LOG --> This is a LOG file appended to by SendFax.  This log file
  144.                 will contain a list of everything SendFax did during its
  145.                 run.  Message numbers fax, killed or toggled as Read will
  146.                 appear in the Log.  Any Errors will also show up here.
  147.                 It would be a good idea to read this file on a regular
  148.                 basis.  Since SendFax appends to it, you may want to delete
  149.                 it or archive it on a regular basis as well.
  150.  
  151. MSGBASE.PTR --> Created by SendFax in the Message Base directory.  This is
  152.                 a simple ASCII Text file containing the last message number
  153.                 worked with.  When the program reloads at a latter time it
  154.                 will attempt to open this file, and if it exists will
  155.                 extract the message number and proceed from that number
  156.                 forward.  This number will be compared against your High
  157.                 and Low Message numbers of the Message base.  If you've
  158.                 packed or renumbered your message base and the saved number
  159.                 is found to be invalid, SendFax will ignore it and start over
  160.                 at the lowest message number.  The actual prefix of the
  161.                 pointer file is the name of your message base.
  162.  
  163.  
  164. Setting up BitFax
  165. --------------------------------------------------------------------------
  166. I followed the instructions for BitFax when installing the software and
  167. suggest you do the same.  Make a subdirectory called BITFAX on your drive,
  168. change to the subdirectory, and copy the contents of the BitFax/SR Program
  169. disk into the subdirectory.  You should place the SendFax files in this
  170. same directory, as SendFax will read the Log file created by BitFax.
  171. You should set the BITFAX=\BITFAX environment variable in your autoexec.bat
  172. file, and include the BITFAX subdirectory in your PATH= statement.
  173.  
  174. Be sure to set your com port correctly on the fax card.  I run a Hayes
  175. Ultra on Com1 and have the fax card set to use Com3/IRQ 4.
  176.  
  177. Once your card is installed and your software is loaded onto the hard
  178. drive you should type BITFAX and set up the BitFax parameters.  Please
  179. follow the BitFax manual.  Their manual contains step by step instructions.
  180. I'd suggest you set the speaker OFF as it is quite noisy!
  181.  
  182.